save vm state

save vm vm_name state

Description

Pauses the CPU state of a guest virtual machine (VM), saves the state to a file, and then moves the VM to "shut-off" state to free resources.

Syntax Description

vm Specifies a virtual machine.
vm_name Specifies the virtual machine name.
state Specifies saving the running CPU state to persist across switch reboots.

Default

N/A.

Usage Guidelines

The saved state persists across switch reboots and virtMgr process restarts. The next time the VM is started, either by explicit start vm vm_name command or by autostart (enable vm vm_name autostart), the saved CPU state is restored.

A suspended VM (suspend vm vm_name) can be saved. In this case, it is returned to a suspended state after the next time it is started, and requires an explicit resume ( resume vm vm_name) to continue processing.

You cannot apply this command to a VM with Integrated Application Hosting (IAH) dedicated ports attached.

Example

The following example saves the vm "vm1" preserving the state:

# save vm vm1 state

History

This command was first available in ExtremeXOS 30.7.

Platform Availability

This command is available on all platforms that support the Integrated Application Hosting (IAH) feature and have a Core or Premier license installed. For a list of platforms that support the IAH feature and for information about licenses, see the Switch Engine v33.1.1 Licensing Guide .